home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 15 / nghints.zip / WININI.TXT < prev    next >
Text File  |  1990-05-01  |  25KB  |  618 lines
  1. ----------
  2. WININI.TXT
  3. ----------
  4.  
  5.  
  6.   NOTE: This is the first of two files that contain
  7.         information about WIN.INI. The second file, named
  8.         WININI2.TXT, is a continuation of the information
  9.         presented here.
  10.  
  11.  
  12. INTRODUCTION
  13. ------------
  14.  
  15. WIN.INI is one of two Windows initialization files that are
  16. included with Windows. Windows initialization files contain
  17. information that defines your Windows environment. Windows
  18. and Windows applications can use the information stored in
  19. these files to configure themselves to meet your needs and
  20. preferences.
  21.  
  22. There are two standard Windows initialization files:
  23.  
  24.   * WIN.INI, which primarily contains settings that allow
  25.     you to alter your Windows environment according to your
  26.     preferences.
  27.  
  28.   * SYSTEM.INI, which primarily contains settings that allow
  29.     you to customize Windows to meet your system's hardware
  30.     needs.
  31.  
  32. This document describes the contents of the WIN.INI file and
  33. explains how to change settings in the file.
  34.  
  35. For information on the SYSTEM.INI file, see the SYSINI.TXT
  36. file.
  37.  
  38.   CAUTION: Changing settings can lead to undesirable results
  39.            when you run Windows. Before changing any
  40.            setting, read "Changing Settings" later in this
  41.            document.
  42.  
  43.  
  44. FORMAT
  45. ------
  46.  
  47. Windows initialization files have the following format:
  48.  
  49.   [section name]
  50.   keyname=value
  51.  
  52. In this example, [section name] is the name of a section.
  53. Sections are used to break settings into logical groups. The
  54. enclosing brackets ([]) are required, and the left bracket
  55. must be in the leftmost column on the screen.
  56.  
  57. The keyname=value statement defines the value of each
  58. setting. A keyname is the name of a setting. It can consist
  59. of any combination of letters and digits, and must be
  60. followed immediately by an equal sign (=). The value can be
  61. an integer, a string, or a quoted string, depending on the
  62. setting.
  63.  
  64. You can include comments in initialization files. You must
  65. begin each line of comments with a semicolon (;).
  66.  
  67.  
  68. HOW TO READ LISTINGS IN THIS DOCUMENT
  69. -------------------------------------
  70.  
  71. In this document, WIN.INI settings are listed alphabetically
  72. within the sections that contain them. These sections appear
  73. in WIN.INI and in this document in the following order
  74. (however, the order of these sections is not important):
  75.  
  76.   [windows]
  77.   [desktop]
  78.   [extensions]
  79.   [intl]
  80.   [ports]
  81.   [fonts]
  82.   [PrinterPorts]
  83.   [devices]
  84.   [colors]
  85.  
  86. In addition, some Windows applications may add or insert
  87. other sections.
  88.  
  89. The settings do not appear alphabetically in WIN.INI. If you
  90. want to change a setting, you will have to search for it
  91. within the appropriate section.
  92.  
  93. The syntax, purpose, and recommended method for changing
  94. each setting appear in the following format:
  95.  
  96. ------------------------------------------------------------
  97. SettingName=<value-type>
  98.   Default: This is Windows' built-in value for this setting.
  99.   Purpose: This paragraph briefly describes the function of
  100.            the setting and its default value (if
  101.            applicable).
  102.   To change: This sentence states the recommended method
  103.            for changing the value of this setting.
  104. ------------------------------------------------------------
  105.  
  106. The <value-type> indicates whether the value should be a
  107. number, a letter, a range of numbers, or something else.
  108.  
  109. A setting that is listed in this document but that does not
  110. appear in your WIN.INI file has the default value.
  111.  
  112.  
  113. CHANGING SETTINGS
  114. -----------------
  115.  
  116. Windows created the WIN.INI file when you installed Windows.
  117. All of the settings contained in this file were set to
  118. default values defined by Windows.
  119.  
  120. You might want to change one or more of these values in
  121. order to change the appearance or performance of Windows to
  122. suit your needs.
  123.  
  124. There are two ways to change WIN.INI settings:
  125.  
  126. * You can use Control Panel to change most settings.
  127.  
  128. * Use a text editor such as Notepad to edit the WIN.INI
  129.   file directly. (Don't use a formatting editor; it can
  130.   corrupt your WIN.INI file.)
  131.  
  132. You can change most settings in WIN.INI by using Control
  133. Panel. By doing so, you avoid opening WIN.INI as a text
  134. file, where it is easier to make mistakes.
  135.  
  136. For more information on Control Panel, see Chapter 5,
  137. "Control Panel," in the User's Guide.
  138.  
  139. For the settings you cannot change by using Control Panel,
  140. you must open the WIN.INI file, edit it using a text editor
  141. such as Notepad, and then restart Windows. For more
  142. information on how to use Notepad, see Chapter 10,
  143. "Additional Accessories," in the User's Guide.
  144.  
  145.   CAUTION: You should use care when making changes to your
  146.            WIN.INI file using a text editor. Incorrect
  147.            changes to WIN.INI can lead to unexpected
  148.            results when you run Windows. In addition, some
  149.            editors can damage certain characters (those
  150.            with ANSI values of greater than 127). It is
  151.            recommended that you use Notepad as a text
  152.            editor. The listings in this document indicate
  153.            which settings you can change using Control
  154.            Panel. Use Control Panel whenever possible.
  155.  
  156.            Always back up your WIN.INI file before you
  157.            open it.
  158.  
  159.  
  160. UPDATING WIN.INI FROM PREVIOUS VERSIONS OF WINDOWS
  161. --------------------------------------------------
  162.  
  163. If you update your system to Windows version 3.0 from
  164. Windows version 2.x, Setup will automatically update your
  165. WIN.INI file by making the following changes:
  166.  
  167. In the [windows] section, Setup will add one setting:
  168.  
  169.   Documents=
  170.  
  171. and will clear the old values from another setting:
  172.  
  173.   Device=
  174.  
  175. In the [extensions] section, Setup will add two settings:
  176.  
  177.   pcx=pbrush.exe ^.pcx
  178.   rec=recorder.exe ^.rec
  179.  
  180. In the [devices] section, Setup will remove all entries. The
  181. previous drivers, fonts, and other resources will remain in
  182. your system. Setup will ask you whether you want to upgrade
  183. to the new driver or stay with the previous one.
  184.  
  185. Setup leaves all other sections unchanged.
  186.  
  187. If you are updating to Windows version 3.0 from Windows
  188. version 1.x, Setup will not preserve any values from your
  189. old WIN.INI file.
  190.  
  191.  
  192. WHAT IS IN WIN.INI?
  193. -------------------
  194.  
  195. The settings in the WIN.INI file allow you to personalize
  196. your Windows environment. WIN.INI contains several sections,
  197. each of which consists of a group of related settings. Your
  198. WIN.INI file might not have all of these sections, or it
  199. might have additional sections, depending on your system's
  200. hardware and software requirements. The following sections
  201. can appear in WIN.INI:
  202.  
  203. This section             Does this
  204. ------------             ---------
  205. [windows]                Affects an assortment of elements
  206.                          in your Windows environment.
  207.  
  208. [desktop]                Controls the appearance of the
  209.                          screen background (desktop) and the
  210.                          positioning of windows and icons.
  211.  
  212. [extensions]             Associates specified types of
  213.                          files with corresponding
  214.                          applications.
  215.  
  216. [intl]                   Describes how to display items for
  217.                          countries other than the United
  218.                          States.
  219.  
  220. [ports]                  Lists all available output ports.
  221.                          These settings are listed in the
  222.                          WININI2.TXT file.
  223.  
  224. [fonts]                  Describes the screen font files
  225.                          that are loaded by Windows.
  226.                          (These settings are listed in the
  227.                          WININI2.TXT file.)
  228.  
  229. [PrinterPorts]           Lists active and inactive output
  230.                          devices that can be accessed by
  231.                          Windows. (These settings are listed
  232.                          in the WININI2.TXT file.)
  233.  
  234.  
  235. [devices]                Lists active output devices
  236.                          that provide compatibility with
  237.                          Windows 2.x applications. (These
  238.                          settings are listed in the
  239.                          WININI2.TXT file.)
  240.  
  241.  
  242. [colors]                 Defines colors for parts of the
  243.                          Windows display. (These settings
  244.                          are listed in the WININI2.TXT
  245.                          file.)
  246.  
  247.  
  248. Additional sections might be inserted by other applications.
  249. Consult the application's documentation for information on
  250. those sections.
  251.  
  252. ------------------------------------------------------------
  253. ------------------------------------------------------------
  254.  
  255. [WINDOWS] SECTION
  256.  
  257. The [windows] section contains settings that affect the
  258. following parts of your Windows environment:
  259.  
  260.   * Applications that start when you start Windows
  261.   * Warning beep
  262.   * Printing
  263.   * Window border width
  264.   * Keyboard speed
  265.   * Mouse settings
  266.   * Definition of files as documents or programs
  267.  
  268. The [windows] section can contain the following settings:
  269.  
  270. ------------------------------------------------------------
  271. Beep=<yes-or-no>
  272.   Default: yes
  273.   Purpose: If this setting is enabled, Windows sounds a
  274.            warning beep when you attempt to do something
  275.            that is not allowed.
  276.   To change: Choose the Sound icon from the Control Panel
  277.            window.
  278. ------------------------------------------------------------
  279. BorderWidth=<number>
  280.   Default: 3
  281.   Purpose: Sets the width of the borders around all the
  282.            windows on your desktop except those (such as
  283.            Control Panel) that have a fixed size. The
  284.            allowed range is 1 (narrowest) to 49 (widest).
  285.   To change: Choose the Desktop icon from the Control Panel
  286.            window.
  287. ------------------------------------------------------------
  288. CursorBlinkRate=<milliseconds>
  289.   Default: 530
  290.   Purpose: Indicates how many milliseconds elapse between
  291.            each blink of the selection cursor.
  292.   To change: Choose the Desktop icon from the Control Panel
  293.            window.
  294. ------------------------------------------------------------
  295. Device=<output-device-name>, <device-driver>,
  296.        <port-connection>
  297.   Default: none
  298.   Purpose: Defines the default printer. The
  299.            <output-device-name> value can be any device name
  300.            given in the [devices] section. An explicit port
  301.            and driver must be assigned to the device. The
  302.            <device-driver> value is the filename (without
  303.            the extension) of the device-driver file. The
  304.            <port-connection> value is any portname given in
  305.            the [ports] section.
  306.   To change: Choose the Printers icon from the Control Panel
  307.            window.
  308. ------------------------------------------------------------
  309. DeviceNotSelectedTimeout=<seconds>
  310.   Default: 15
  311.   Purpose: Specifies the default number of seconds for
  312.            Windows to wait for a device to be switched on. A
  313.            value is saved for each printer listed in the
  314.            [PrinterPorts] section. If the device is not
  315.            switched on during this time, Windows won't print
  316.            to the device. Note that for some devices,
  317.            Windows immediately posts an error message if the
  318.            device is not already switched on.
  319.   To change: Use Notepad to edit the WIN.INI file. This
  320.            setting serves only as the system default value.
  321.            To change the value for a particular printer,
  322.            choose the Printers icon from the Control Panel
  323.            window. Using Control Panel changes the
  324.            corresponding value only in the [PrinterPorts]
  325.            section.
  326. ------------------------------------------------------------
  327. Documents=<extensions>
  328.   Default: none
  329.   Purpose: Defines files that are to be considered
  330.            "documents" by Windows. Files with the extensions
  331.            listed in the [extensions] section of WIN.INI are
  332.            automatically considered documents. Use this
  333.            setting to define only document file extensions
  334.            that are not in the [extensions] section. The
  335.            extensions listed here are not associated with
  336.            any application. Separate extension names with a
  337.            space, and do not include the preceding periods.
  338.   To change: Use Notepad to edit the WIN.INI file.
  339. ------------------------------------------------------------
  340. DoubleClickSpeed=<milliseconds>
  341.   Default: 452
  342.   Purpose: Establishes the maximum amount of time between
  343.            clicks of the mouse button that the system
  344.            will permit for one double-click. The lower the
  345.            value, the less time you have to click twice in
  346.            order to effect a double-click.
  347.   To change: Choose the Mouse icon from the Control Panel
  348.            window.
  349. ------------------------------------------------------------
  350. KeyboardSpeed=<milliseconds>
  351.   Default: 31
  352.   Purpose: Establishes how much time elapses between
  353.            repetitions of a character on the display when
  354.            you hold down a keyboard key. This setting does
  355.            not work for all keyboards. If you delete this
  356.            setting from WIN.INI, Windows Setup will not set
  357.            this speed, but the speed will still be set if
  358.            you choose the Keyboard icon in Control Panel
  359.            (even if you cancel out of it).
  360.   To change: Choose the Keyboard icon from the Control Panel
  361.            window.
  362. ------------------------------------------------------------
  363. Load=<filename(s)>
  364.   Default: none
  365.   Purpose: Specifies one or more applications that are to be
  366.            run as icons when Windows is started. This
  367.            value is a list of one or more filenames of
  368.            applications, or documents that are associated
  369.            with an application, each separated by a space.
  370.   To change: Use Notepad to edit the WIN.INI file.
  371. ------------------------------------------------------------
  372. MouseSpeed=<0-or-1-or-2>
  373.   Default: 1
  374.   Purpose: Establishes the relationship between mouse
  375.            movement and cursor movement when the value of
  376.            either MouseThreshold1 or MouseThreshold2 is
  377.            exceeded. When this occurs, Windows causes cursor
  378.            movement to accelerate according to the value of
  379.            MouseSpeed. If it is 0, there is no acceleration.
  380.            If it is 1, the cursor is moved twice the normal
  381.            speed when mouse movement exceeds the value of
  382.            MouseThreshold1. If it is 2, the cursor is moved
  383.            twice the normal speed when mouse movement
  384.            exceeds the value of MouseThreshold1 or four
  385.            times the normal speed if mouse movement exceeds
  386.            MouseThreshold2.
  387.   To change: Choose the Mouse icon from the Control Panel
  388.            window.
  389. ------------------------------------------------------------
  390. MouseThreshold1=<pixels>
  391.   Default: 5
  392.   Purpose: Establishes the maximum number of pixels that
  393.            the mouse can move between mouse interrupts
  394.            before Windows alters the relationship between
  395.            mouse movement and cursor movement. If the mouse
  396.            movement exceeds this threshold and MouseSpeed is
  397.            greater than zero, Windows moves the cursor at
  398.            twice the normal speed.
  399.   To change: Choose the Mouse icon from the Control Panel
  400.            window.
  401. ------------------------------------------------------------
  402. MouseThreshold2=<pixels>
  403.   Default: 10
  404.   Purpose: Establishes the maximum number of pixels that
  405.            the mouse can move between mouse interrupts
  406.            before Windows alters the relationship between
  407.            mouse movement and cursor movement. If the mouse
  408.            movement exceeds this threshold and MouseSpeed is
  409.            equal to 2, Windows moves the cursor at four
  410.            times the normal speed.
  411.   To change: Choose the Mouse icon from the Control Panel
  412.            window.
  413. ------------------------------------------------------------
  414. NetWarn=<0-or-1>
  415.   Default: 1
  416.   Purpose: Specifies whether Windows should display a
  417.            warning message if your system is configured to
  418.            run a network and the network is not running or
  419.            the wrong network is running. All Windows
  420.            network-related options will be disabled if the
  421.            network is disabled or incorrect. Setting this
  422.            value to 0 will disable the warning message.
  423.   To change: Choose the Network icon from the Control Panel
  424.            window.
  425. ------------------------------------------------------------
  426. NullPort=<string>
  427.   Default: "None"
  428.   Purpose: Specifies the name used for a null port. This
  429.            name appears in the Printers-Configure dialog box
  430.            in Control Panel when a device is installed (that
  431.            is, the device driver is present) but is not
  432.            connected to any port. This value also appears
  433.            for such a device in the [devices] section of
  434.            WIN.INI.
  435.   To change: Use Notepad to edit the WIN.INI file.
  436. ------------------------------------------------------------
  437. Programs=<extensions>
  438.   Default: com exe bat pif
  439.   Purpose: Defines which files Windows regards as
  440.            applications. Extension names are separated by a
  441.            space and do not include the preceding periods.
  442.   To change: Use Notepad to edit the WIN.INI file.
  443. ------------------------------------------------------------
  444. Run=<filename(s)>
  445.   Default: none
  446.   Purpose: Tells Windows to run one or more specified
  447.            applications when Windows is started. The value
  448.            is a list of one or more filenames of
  449.            applications, or documents associated with
  450.            applications, each separated by a space.
  451.   To change: Use Notepad to edit the WIN.INI file.
  452. ------------------------------------------------------------
  453. Spooler=<yes-or-no>
  454.   Default: yes
  455.   Purpose: Specifies whether output to the printer is to be
  456.            sent through Print Manager. Changing this value
  457.            to no disables Print Manager.
  458.   To change: Choose the Printers icon from the Control Panel
  459.            window.
  460. ------------------------------------------------------------
  461. TransmissionRetryTimeout=<seconds>
  462.   Default: 45
  463.   Purpose: Specifies the default amount of time to give
  464.            Windows for attempted transmission retries. A
  465.            value is saved for each printer in the
  466.            [PrinterPorts] section. If a successful
  467.            transmission does not occur during this time,
  468.            Windows posts a message box stating that the
  469.            printer is not receiving characters.
  470.   To change: Use Notepad to edit the WIN.INI file. This
  471.            setting serves only as the system default value.
  472.            To change the value for a particular printer,
  473.            choose the Printers icon from the Control Panel
  474.            window. Using Control Panel changes the
  475.            corresponding value only in the [PrinterPorts]
  476.            section.
  477. ------------------------------------------------------------
  478. ------------------------------------------------------------
  479.  
  480. [DESKTOP] SECTION
  481.  
  482. The [desktop] section contains optional settings that
  483. control the appearance of the screen background (desktop)
  484. and the positioning of windows and icons on the screen.
  485.  
  486. The [desktop] section can contain the following settings:
  487.  
  488. ------------------------------------------------------------
  489. GridGranularity=<number>
  490.   Default: 0
  491.   Purpose: Specifies the size (in units of eight pixels)
  492.            of the grid that Windows uses to position
  493.            windows on the screen. The allowed range is 0
  494.            through 49.
  495.   To change: Choose the Desktop icon from the Control Panel
  496.            window.
  497. ------------------------------------------------------------
  498. IconSpacing=<pixels>
  499.   Default: 77
  500.   Purpose: Specifies the number of pixels that will appear
  501.            between icons. Increasing this number increases
  502.            the amount of space between icons.
  503.   To change: Choose the Desktop icon from the Control Panel
  504.            window.
  505. ------------------------------------------------------------
  506. Pattern=<b1 b2 b3 b4 b5 b6 b7 b8>
  507.   Default: "(None)"  (This string appears when no pattern
  508.                       is specified)
  509.   Purpose: Specifies a pattern that is used to paint the
  510.            screen background. The eight numeric values
  511.            define a bitmap eight pixels wide and eight
  512.            pixels high. Each decimal value represents a
  513.            byte, and each byte represents a row of eight
  514.            pixels. The following shows the effect of setting
  515.            a bit:
  516.  
  517.            Setting   Effect
  518.            -------   ------
  519.               0      Sets the corresponding pixel to the
  520.                      background color (specified by the
  521.                      Background setting in the [colors]
  522.                      section).
  523.  
  524.               1      Sets the corresponding pixel to the
  525.                      foreground color (specified by the
  526.                      WindowText setting in the [colors]
  527.                      section).
  528.  
  529.            For example, if you set the <b1> value to the
  530.            decimal value 175, the top row of pixels in the
  531.            bitmap will appear as the binary equivalent
  532.            (10101111) according to the preceding table.
  533.  
  534.   To change: Choose the Desktop icon from the Control Panel
  535.            window.
  536. ------------------------------------------------------------
  537. TileWallpaper=<0-or-1>
  538.   Default: 0
  539.   Purpose: Specifies whether to tile the desktop wallpaper
  540.            across the screen (set this value to 0) or to
  541.            center it (set this value to 1).
  542.   To change: Choose the Desktop icon from the Control Panel
  543.            window.
  544. ------------------------------------------------------------
  545. Wallpaper=<bitmap-filename>
  546.   Default: "(None)"  (This string appears when no pattern
  547.                       is specified)
  548.   Purpose: Supplies the name of a bitmap file. This bitmap
  549.            appears on the screen background. You need to
  550.            include the full pathname of the file if it is
  551.            not in the Windows or system directory.
  552.   To change: Choose the Desktop icon from the Control Panel
  553.            window.
  554. ------------------------------------------------------------
  555. WallpaperOriginX=<x-coordinate>
  556.   Default: 0
  557.   Purpose: Adjusts the initial offset of a tiled wallpaper.
  558.            The x-origin (default value) is the left side
  559.            of the screen.
  560. To change: Use Notepad to edit the WIN.INI file.
  561. ------------------------------------------------------------
  562. WallpaperOriginY=<y-coordinate>
  563.   Default: 0
  564.   Purpose: Adjusts the initial offset of a tiled wallpaper.
  565.            The y-origin (default value) is the top of the
  566.            screen.
  567.   To change: Use Notepad to edit the WIN.INI file.
  568. ------------------------------------------------------------
  569. ------------------------------------------------------------
  570.  
  571. [EXTENSIONS] SECTION
  572.  
  573. The [extensions] section contains settings that link groups
  574. of document files with an application so that opening one of
  575. the document files automatically starts the application.
  576.  
  577. The [extensions] section can contain settings of the
  578. following type:
  579.  
  580. ------------------------------------------------------------
  581. <extension>=<command-line>
  582.  
  583.   Purpose: Contains a list of filename extensions that
  584.            identify documents, and corresponding command
  585.            lines that are invoked when you choose a file
  586.            that has the associated extensions.
  587.  
  588.            The <extension> keyname is an extension of one to
  589.            three characters. The <command-line> value is an
  590.            ordinary DOS command line. The command line
  591.            always begins with an application filename (with
  592.            the .EXE extension). This can be followed by any
  593.            command parameters the application needs, usually
  594.            including the document filename. The caret (^)
  595.            character can be used when the original document
  596.            filename is needed in the command line; the caret
  597.            is replaced by the document filename without any
  598.            extension. The most typical <extension> entries
  599.            simply list the application name and the document
  600.            name; for example:
  601.  
  602.              CAL=CALENDAR.EXE ^.CAL
  603.  
  604.            If you run a file called MYFILE.CAL after this
  605.            association has been made, the Calendar progam
  606.            will start and automatically open the file named
  607.            MYFILE.
  608.  
  609.   To change: Choose Associate from the File menu in File
  610.            Manager.
  611.  
  612. ------------------------------------------------------------
  613. ------------------------------------------------------------
  614.  
  615. NOTE: See the WININI2.TXT file for the [intl], [ports],
  616.       [fonts], [PrinterPorts], [devices], and [colors]
  617.       section listings.
  618.